home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / drv_hztousec.z / drv_hztousec
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ddddrrrrvvvv____hhhhzzzzttttoooouuuusssseeeecccc((((DDDD3333))))                                              ddddrrrrvvvv____hhhhzzzzttttoooouuuusssseeeecccc((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _dddd_rrrr_vvvv______hhhh_zzzz_tttt_oooo_uuuu_ssss_eeee_cccc - convert clock ticks to microseconds
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _cccc_llll_oooo_cccc_kkkk______tttt _dddd_rrrr_vvvv______hhhh_zzzz_tttt_oooo_uuuu_ssss_eeee_cccc_((((_cccc_llll_oooo_cccc_kkkk______tttt _t_i_c_k_s_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _t_i_c_k_s     The number of clock ticks to convert to equivalent
  18.                microseconds.
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      _dddd_rrrr_vvvv______hhhh_zzzz_tttt_oooo_uuuu_ssss_eeee_cccc converts the length of time expressed by _t_i_c_k_s, which is in
  22.      units of clock ticks, into units of microseconds.
  23.  
  24.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  25.      _dddd_rrrr_vvvv______hhhh_zzzz_tttt_oooo_uuuu_ssss_eeee_cccc returns the number of microseconds equivalent to the _t_i_c_k_s
  26.      argument.  No error value is returned.  If the microsecond equivalent to
  27.      _t_i_c_k_s is too large to be represented as a _cccc_llll_oooo_cccc_kkkk______tttt, then the maximum
  28.      _cccc_llll_oooo_cccc_kkkk______tttt value is returned.
  29.  
  30. UUUUSSSSAAAAGGGGEEEE
  31.      Several functions either take time values expressed in clock ticks as
  32.      arguments [_iiii_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt(D3), _dddd_eeee_llll_aaaa_yyyy(D3)] or return time values expressed in
  33.      clock ticks [_dddd_rrrr_vvvv______gggg_eeee_tttt_pppp_aaaa_rrrr_mmmm(D3)].  The length of a clock tick can vary
  34.      across different implementations, and therefore drivers should not
  35.      include any hard-coded assumptions about the length of a tick.
  36.      _dddd_rrrr_vvvv______hhhh_zzzz_tttt_oooo_uuuu_ssss_eeee_cccc and the complementary function _dddd_rrrr_vvvv______uuuu_ssss_eeee_cccc_tttt_oooo_hhhh_zzzz(D3) can be used,
  37.      as necessary, to convert between clock ticks and microseconds.
  38.  
  39.      Note that the time value returned by _dddd_rrrr_vvvv______gggg_eeee_tttt_pppp_aaaa_rrrr_mmmm with an _LLLL_BBBB_OOOO_LLLL_TTTT argument
  40.      will frequently be too large to represent in microseconds as a _cccc_llll_oooo_cccc_kkkk______tttt.
  41.      When using _dddd_rrrr_vvvv______gggg_eeee_tttt_pppp_aaaa_rrrr_mmmm together with _dddd_rrrr_vvvv______hhhh_zzzz_tttt_oooo_uuuu_ssss_eeee_cccc to time operations,
  42.      drivers can help avoid overflow by converting the difference between
  43.      return values from successive calls to _dddd_rrrr_vvvv______gggg_eeee_tttt_pppp_aaaa_rrrr_mmmm instead of trying to
  44.      convert the return values themselves.
  45.  
  46.    LLLLeeeevvvveeeellll
  47.      Initialization, Base or Interrupt.
  48.  
  49.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  50.      Does not sleep.
  51.  
  52.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  53.      across calls to this function.
  54.  
  55. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  56.      _dddd_eeee_llll_aaaa_yyyy(D3), _dddd_rrrr_vvvv______gggg_eeee_tttt_pppp_aaaa_rrrr_mmmm(D3), _dddd_rrrr_vvvv______uuuu_ssss_eeee_cccc_tttt_oooo_hhhh_zzzz(D3), _iiii_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt(D3)
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.